home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 029a / howmuc10.zip / HOWMUCH.DOC next >
Text File  |  1991-11-15  |  7KB  |  184 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.         
  8.         HOWMUCH
  9.         Copyright 1991 by Chuck Steenburgh
  10.         
  11.            HOWMUCH Version 1.0 will report the amount of space occu-
  12.         pied by a group of files, both via a screen report and via
  13.         the DOS errorlevel.
  14.         
  15.         Usage:       HOWMUCH [d:][\path\]filespec [/SK | /SM] [/C] [/H]
  16.         
  17.                   d:              optional drive specifier
  18.                   
  19.                   \path\          optional directory path
  20.                   
  21.                   filespec        files whose sizes are to be totalled
  22.                                   wildcards are permitted
  23.                                   
  24.                   /SK             report space in kilobytes
  25.                   
  26.                   /SM             report space in megabytes
  27.                   
  28.                   /C              center screen output on current line
  29.                   
  30.                   /H              display brief syntax help
  31.                   
  32.         Examples:
  33.         
  34.              HOWMUCH *.*          displays the space taken by all files
  35.                                   in the current directory in bytes.
  36.                                   
  37.              HOWMUCH c:\*.* /sk   displays the space taken by all files
  38.                                   in the root directory of drive C:, in
  39.                                   kilobytes.
  40.                                   
  41.              HOWMUCH a:\*.com /sm displays the space taken by all files
  42.                                   with the extension .COM in the root
  43.                                   directory of drive A:, in megabytes.
  44.                                   
  45.              HOWMUCH FILES.*      displays the space taken by all files
  46.                                   with filename FILES (any extension)
  47.                                   in the current directory.
  48.                                   
  49.            The default is to display space taken in bytes.  The error-
  50.         level will also be set to reflect the amount of space taken.
  51.         The errorlevel is ALWAYS reported in 10k (10,240 bytes) incre-
  52.         ments.  If more than 2,590,720 bytes (2530 kbytes or 2.47 meg)
  53.         is taken, the errrorlevel is set to 253.  If 0 bytes are taken
  54.         (i.e., no files matching filespec) the errorlevel is set to
  55.         255.  The errorlevel is set to 254 if the /H help switch is
  56.         specified.  See the table below for examples:
  57.         
  58.            Space taken (bytes)         /K         /M       Errorlevel
  59.            ===================         ==         ==       ==========
  60.                  247,316              241.52       0.24        24
  61.  
  62.                                      Page 1
  63.  
  64.  
  65.  
  66.  
  67.  
  68.                1,546,764            1,510.51       1.47       151
  69.                3,432,124            3,351.68       3.27       253
  70.                        0                0          0          255
  71.                        
  72.            HOWMUCH will total file sizes for ALL files, including 
  73.         hidden, read only, and system files, as long as they match the
  74.         filespec provided on the command line.
  75.         
  76.         DISCLAIMER
  77.         
  78.            The programs described in this documentation are guaran-
  79.         teed to absolutely nothing!  They have, however, in my exper-
  80.         ience performed essentially as described herein.  The author
  81.         will not be responsible for any loss or damages caused through
  82.         the use of these programs.
  83.         
  84.            All trademarks are property of their respective owners.
  85.         
  86.            The programs and documentation are Copyright 1991 by Chuck
  87.         Steenburgh.  You are encouraged to distribute these programs
  88.         provided the following conditions are met:
  89.         
  90.            - all files listed in the file FILES.TXT must be distrib-
  91.              uted together in UNMODIFIED form
  92.         
  93.            - you charge no more than a reasonable fee for copying or
  94.              subscription, and clearly indicate that payment of such
  95.              a fee does NOT grant ownership of the programs.
  96.         
  97.            This program is part of set of utilities known as STEEN-
  98.         BURGH'S STUFF (Mildly Useful Utilities).  The full set of
  99.         utilities includes the following programs:
  100.         
  101.              BATBOX:     Simple menu creation/input system
  102.              CLK:        Displays time on screen
  103.              DOSVER:     Checks for DOS version currently running
  104.              FREEDISK:   Checks for available disk space
  105.              HOWMUCH:    Displays space occupied by a group of files
  106.              INPUT:      Simple prompt/input system
  107.              KLS:        Colorful screen-clearing utility
  108.              LAUNCHER:   File selection/execution system
  109.              MUSIC:      Plays transcribed sheet music on the PC
  110.              RAND:       Random number generator
  111.              SKIP:       Prints blank lines from batch files
  112.              SOUNDER:    Wide range of noise making options
  113.              WAITFOR:    Timed pauses 
  114.              WHENISIT:   Date/time telling utility
  115.              WRITE:      Colorful output anywhere on screen
  116.              XD:         Create/switch directories at the same time
  117.         
  118.            Payment of the $10 registration fee automatically registers
  119.         you for the full set.
  120.         
  121.            You may evaluate these programs for up to 30 days on a free
  122.  
  123.                                      Page 2
  124.  
  125.  
  126.  
  127.  
  128.  
  129.         trial basis.  After 30 days, you should register your use of
  130.         these programs.  The registration fee is $10, payable to the
  131.         author at the address given below.
  132.         
  133.            Let's be real: I don't plan to make alot of money this way.
  134.         Registration does have its advantages:
  135.         
  136.            - I am improving these programs all the time.  Registration
  137.              will get you IMMEDIATELY a disk with the latest version,
  138.              which includes a version of BATBOX with user-selected 
  139.              menu colors.  When Version 2.0 of these utilities is re-
  140.              leased, you will also receive that free of charge.
  141.         
  142.            - While I can't promise to include everyone's suggestions
  143.              in program updates, you can bet I'll listen to registered
  144.              users before any of you scrounges out there.
  145.         
  146.            - You will me feel all warm and fuzzy and appreciated, and
  147.              all that good stuff.
  148.         
  149.            - You will also get an evaluation copy of my text-file for-
  150.              matting program (used to produce the margins in this doc-
  151.              ument).
  152.         
  153.            Send comments/registrations to:
  154.         
  155.                 Chuck Steenburgh
  156.                 304A North Main Street
  157.                 Lexington, VA 24450
  158.                 (703)464-5290
  159.         
  160.                 CIS 72330,1776 (I haunt the IBMSYS and IBMPRO forums)
  161.         
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.                                      Page 3